Das Windows-Subsystem für Android™️ ermöglicht es Ihrem Windows 11-Gerät, die im Amazon Appstore verfügbaren Android-Anwendungen auszuführen. Android ist eine Marke von Google LLC. Wenn Sie ein Entwickler sind, der sich für Windows-Desktopgeräte und die Optimierung des Windows-Betriebssystems interessiert, ist dieser Leitfaden für Sie geeignet.

Um Ihre Android-App auf Windows 11-Geräten verfügbar zu machen, müssen Sie folgende Schritte ausführen:

Weitere Informationen oder Unterstützung:

Dieser Leitfaden unterstützt Sie beim Testen und Debuggen Ihrer Android-App auf Windows:

Möchten Sie mehr über die Roadmap für das Windows-Subsystem für Android erfahren, Probleme bei der Entwicklung diskutieren und Bugs oder Funktionsanfragen an das Subsystem-Team senden? Besuchen Sie die GitHub-Seite für Entwickler für das Windows-Subsystem für Android.

Mit dem Vorschauprogramm „Windows-Subsystem für Android ™️“ können Benutzer frühe Vorschaubuilds des Windows-Subsystems für Android™ und Amazon Appstore unter Windows erhalten. Weitere Details finden Sie auf der Seite zum Vorschauprogramm.

Um Ihre Android-App in der Windows-Desktopumgebung zu testen, müssen einige Einrichtungsschritte ausgeführt werden.

Das Windows-Subsystem für Android ist unter Windows 11 verfügbar. Ihr Gerät muss bestimmte Anforderungen erfüllen: Geräteanforderungen.

Der Microsoft Store installiert das Windows-Subsystem für Android automatisch im Hintergrund, wenn eine der beiden folgenden Benutzeraktionen ausgeführt wird:

Der Amazon Appstore und die Einstellungen-App des Windows-Subsystems für Android werden dann im Windows 11-Startmenü angezeigt, sind bei der Suche verfügbar und bieten einen Katalog mit Android-Apps.

Hinweis

Amazon Appstore unter Windows (eine Voraussetzung für die Ausführung von Android-Apps unter Windows 11) ist in ausgewählten Regionen verfügbar.

Um auf die Einstellungen-App des Windows-Subsystems für Android zuzugreifen, navigieren Sie zu: Start > Alle Apps > Windows-Subsystem für Android™️-Einstellungen. Weitere Informationen zu bestimmten App-Features der Einstellungen-App: Verwalten von Einstellungen für mobile Apps auf Windows.

Es gibt einige einzigartige Verhaltensweisen bei der Eingabe zu berücksichtigen, die wahrscheinlich Aktualisierungen Ihres Android-App-Codes erfordern, der für Handheldgeräte entwickelt wurde, damit er bei der Ausführung auf einem Windows-Desktopgerät über den Amazon Appstore kompatibel ist.

Für Texteingabefelder, die von einer virtuellen Bildschirmtastatur-Eingabemethode (oder IME) verarbeitet werden, z. B. EditText, sollten sich Apps wie erwartet verhalten. (EditText-Klasse in der Android-Dokumentation).

Für Tastatureingaben, die vom Framework nicht erwartet werden können, müssen Apps das Verhalten selbst verarbeiten. Wenn dies bereits in der App implementiert ist, ist keine zusätzliche Arbeit erforderlich.

Beispielsweise unterstützen einige Spiele möglicherweise bereits Bewegung, die neben Toucheingaben über Tastatur (Tasten wasd) ermöglicht wird.

Im Folgenden finden Sie Tastatureingaben, für die Entwickler bei der Entwicklung für Windows 11-Geräte Codeaktualisierungen in Betracht ziehen sollten:

Weitere Informationen zum Optimieren dieser Tastatureingabeszenarien auf Desktopgeräten finden Sie in der Android-Dokumentation:

Entwickler sollten bei der Entwicklung für Windows-Geräte in Betracht ziehen, den Code für die folgenden Mauseingaben zu aktualisieren:

Mauseingaben müssen ähnlich wie Tastatureingaben den offiziellen Android-App-Richtlinien entsprechen. Das bedeutet, die mit der SOURCE_MOUSE-Konstante gekoppelte InputDevice-Klasse muss verwendet werden. Weitere Informationen zum Optimieren dieser Mauseingabeszenarien auf Desktopgeräten finden Sie in der Android-Dokumentation:

Im Gegensatz zu herkömmlichen Formfaktoren für Mobilgeräte können Android-Apps, die auf Windows 11 ausgeführt werden, frei in ihrer Größe geändert werden, sollten bei der Größenänderung reaktionsfähig sein und können mithilfe von Windows-Aktionen/Gesten ausgerichtet werden.

Windows 11 erzwingt eine Mindestbildschirmauflösung von 720p (1280 x 720) mit einem a >>9”-Bildschirm.

Wenn das Seitenverhältnis einer Fenstergröße nicht zwischen den Gerätebildschirmgrößen ausgerichtet werden kann, auf denen das Fenster angezeigt wird, kann dies zu Letterboxing (das Fenster ist breiter als hoch oder horizontal länger) oder Pillarboxing (das Fenster ist schmaler als breit oder vertikal länger) führen. Das Ergebnis sind Balken, die an den Seiten des Fensters platziert werden, um es zu zentrieren. Diese Balken können je nach den ausgewählten Systemeinstellungen von hellem oder dunklem Design sein. Dies geschieht nur bei Bedarf, wenn die Android-App angedockt oder maximiert wird, sodass Android-Apps die umfassenden Andockfunktionen in Windows nutzen und in das Fenstermodell integrieren können.

Folgendes sollte beim Aktualisieren einer Android-App für die Ausführung auf einem Windows 11-Gerät in Bezug auf die Fensterverwaltung und Größenänderung ebenfalls berücksichtigt werden:

Weitere Informationen zum Optimieren von Fensteränderungsszenarien auf Desktopgeräten finden Sie im Leitfaden zur Fensterverwaltung in der Android-Dokumentation.

Wenn Sie Android-Anwendungen für eine Umgebung mit mehreren Fenstern entwickeln, hat das Auswirkungen auf die in Ihrer Anwendung verwendeten Lebenszyklusereignisse. Das Überschreiben des Ereignisses onPause liefert zwar möglicherweise auf einem Smartphone oder Tablet die gewünschten Ergebnisse, für den Wechsel der Benutzeroberfläche Ihrer App ist es jedoch in der Regel das falsche Ereignis.

Eine Beschreibung der Lebenszyklusereignisse finden Sie in der Android-Dokumentation. In den meisten Fällen sollten Sie das Ereignis onStop und nicht das Ereignis onPause oder onUserLeaveHint verwenden. Viele Android-Implementierungen mit mehreren Fenstern stellen die Benachrichtigung onUserLeaveHint gar nicht bereit. Das führt dazu, dass unternehmenskritische Logik, die sich in diesem Ereignishandler befindet, auf diesen Plattformen nicht aufgerufen wird – einschließlich des Windows-Subsystems für Android.

Zum Testen und Debuggen Ihrer App auf einem Windows 11-Gerät mithilfe des Windows-Subsystems für Android sind die folgenden Einrichtungsschritte erforderlich.

Sie müssen zuerst den Entwicklermodus in Windows-Einstellungen aktivieren. Es gibt drei Möglichkeiten, den Entwicklermodus zu aktivieren:

So stellen Sie eine Verbindung mit dem Windows-Subsystem für Android zum Debuggen her:

Starten Sie eine Android-App, die über den Amazon Appstore installiert wurde.

Sie können eine Verbindung mit adb connect mit dem folgenden Befehl herstellen (adb muss installiert sein):

So stellen Sie von Windows/Mac eine Verbindung mit einem Testgerät (mit installierten Windows-Subsystem für Android) im selben Netzwerk her:

Öffnen Sie auf dem Testgerät (auf dem das Windows-Subsystem für Android installiert ist) ein PowerShell-Fenster, und identifizieren Sie die IP-Adresse des Testgeräts, indem Sie den folgenden Befehl ausführen:

Geben Sie über das Terminal des Geräts zum Debuggen, in dem Android Studio und das Android SDK installiert ist (Mac/Windows), den folgenden Befehl ein:

Die finden Sie in der Ausgabe von „ipconfig“ vom Testgerät. Sie können Apps auch über Android Studio bereitstellen und debuggen.

Wenn Sie Android Debug Bridge (ADB) verwenden möchten, um Ihre Entwicklungsarbeitsstation direkt mit Ihrem Android-Gerät zu verbinden, damit Sie Pakete installieren und Änderungen auswerten können, finden Sie Informationen in der Dokumentation zu Android Debug Bridge in Android Open Source.

Apps sollten zwar mit Amazon Appstore installiert werden, ist das Debuggen einer Android-App auf einem Windows-Gerät mit einem APK (Android-Anwendungspaket) und adb (Android Debug Bridge) möglich.

So debuggen Sie ein APK mithilfe von adb

Führen Sie die oben beschriebenen Schritte aus, um eine Verbindung mit der Windows-Subsystem für Android-VM herzustellen.

Installieren des APK mit dem adb-Installationsbefehl: adb install app-debug.apk

Erwartete Ausgabe:

Im Windows-Benachrichtigungsmenü wird eine Erfolgsbenachrichtigung „App installiert“ angezeigt, und die App wird gestartet, sobald sie ausgewählt wird.

Das Windows-Subsystem für Android nutzt Intel Bridge-Technologie, um Arm-Anwendungen auf x86-basierten Prozessoren zu emulieren. Arm-Anwendungen können auf Arm-basierten Prozessoren nativ ausgeführt werden. Die Emulationsebene verursacht einen Leistungsmehraufwand. Um eine optimale Leistung zu erzielen, übermitteln Sie Ihre Anwendung für die x86-64- und die Arm64-Architektur.

Das Windows-Subsystem für Android verwendet einen virtuellen Computer (VM), der Kompatibilität mit dem AOSP-Framework und Geräten wie Tastatur, Maus, Toucheingabe, Stift usw. bietet.

Es gibt drei mögliche Zustände für die VM, auf der Apps mit dem Windows-Subsystem für Android ausgeführt werden:

Übergänge zwischen diesen Zuständen werden durch Benutzeraktivitäten ausgelöst, z. B. durch Starten oder Interaktion mit der Android-App oder eine App-Benachrichtigung. Android-Apps werden angehalten und dann beendet, wenn ihr Fenster minimiert wird.

Die Eigenschaften für das Windows-Subsystem für Android-VMs sind unten aufgeführt. Das Hartcodieren dieser Werte wird nicht empfohlen, da dies zu zukünftigen Inkompatibilitäten führen kann.

Das Windows-Subsystem für Android führt eine softwarebasierte Verschlüsselung auf Dateiebene durch.

Sowohl Windows-Kernelmodustreiber als auch Windows-Anwendungen, die auf mittlerer Integritätsebene (IL) ausgeführt werden, können beliebige Android-Container und den Android-App-Arbeitsspeicher untersuchen. Kurzfristig ist nicht geplant, die Erkennung von Cheatprogrammen/Makros/Bots/verdächtigem Verhalten hinzuzufügen.

Entwickler, die getSecurityLevel abfragen, erhalten SECURITY_LEVEL_SW_SECURE_CRYPTO. Weitere Informationen zu getSecurityLevel finden Sie im Referenzhandbuch zur Android-API.

Sie können das Windows-Subsystem für Android deinstallieren. Beachten Sie jedoch, dass auch alle zugehörigen Apps deinstalliert werden.

Wenn unter Windows spezifische Probleme mit Amazon Appstore auftreten, führen Sie die folgenden Schritte zur Problembehandlung aus:

Weitere Schritte zur Problembehandlung im Zusammenhang mit der Einstellungen-App des Windows-Subsystems für Android oder Informationen dazu, wie Sie Feedback über den Feedback-Hub abgeben können, finden Sie unter Problembehandlung und häufig gestellte Fragen zu mobilen Apps unter Windows.

Bei anderen Fragen und für Unterstützung für Entwickler verwenden Sie das Tag „Windows-Subsystem für Android“ unter Microsoft F&A.